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**F ILE**1D**BOOTBLOCK 
BBBBBBBB 000000 000000 TTTTTTTTTT BBBBBB8B LL 000000 cccccccc KK KK 
BBBBBBBB 000000 000000 TTTTTTTTTT BBBBBBBB LL 000000 cccccccc §=KK KK 
BB 00 00 00 00 TT BB BB LL 00 oo CC KK KK 
BB 00 00 00 00 TT BB BB LL 00 oo cc KK KK 
BB BB 00 00 00 00 TT BB BB LL 00 oo CC KK KK 
8B BB 00 00 00 00 TT BB BB LL 00 oo CC KK 
BBBBBBBB 00 00 00 00 TT BBBBBBBB LL 00 oo CC KKKKKK 
B 00 00 00 00 TT BBBBBBBB LL 00 oo CC KKKKKK 
8B BB 00 00 00 00 TT BB BB LL 00 oo CC K KK 
BB BB 00 00 00 00 TT BB BB LL 00 oo CC KK KK 
BB BB 00 00 00 00 TT BB BB LL 00 oo CC KK KK eos 
8B BB 00 00 00 00 TT BB BB LL 00 oo cc KK KK eee 
BBBBBBBB 000000 000000 TT BBBBBBBB LLLLLLLLLL 000000 CCCCCCCC CKK KK eee 
BBBBBBBB 000000 000000 TT BBBBBBBB LLLLLLLLLL 000000 Cccccccce KK KK cece 
LL III] SSSSSSSS 
LL HII SSSSSSSS 
LL I] SS 
LL I] $s 
LL II SS 
LL I] SS 
LL I] SSSSSS 
LL I] SSSSSS 
LL I] SS 
LL I] SS 
LL I] SS 
LL I] SS 
LLELLLLLLLL III] SSSSSSSS 
LLLLLLLLLL HII! SSSSSSSS 
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BOOTS.SRC JBOOTBLOCK .MAR; 1 (1) 
-TITLE BOOTBLOCK 
- IDENT *y04~ 000" 


MARABRABRABAAAASALALASELALALE SERA LETS SESSA SERRE ASAE SESE EERE SESE EERE EERE ELS SY 


COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


* 

® 

* 

® 

® 

ca 
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE * 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER * 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
*® 

® 

® 

® 

® 

.¢ 

® 

*® 

® 

® 

® 


TRANSFERRED. 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
Sepak at itn NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


DIGITAL ASSUMES NO RESPONS . 


IBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH 


L 
S NOT SUPPLIED BY DIGITAL. 
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FACILITY: 
Device-independent boot block for VAX 
ABSTRACT: 


Reads a file (usually VMB.EXE) off the booting medium into 
memory and transfers control to the VMB code. 


AUTHOR: 
Carol Peters 23 August 1979 
REVISION HISTORY: 


Robert Rappaport 13 Sept 1979 r 
Simplified references to local data items. 
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Reserve space to contain 
# blocks in primary boot. 
Swapped words of start LBN. 


Load address for primary boot. 
NOTE = the load address here is 
relative to the base of the 64KB 
of physical memory in which we are 
perrenwer hee - As explained 
below, the UNIBUS (or MASSBUS) map 
registers numbered 0-127 will be 
mapped to this same 64KB. Therefore, 
this address, as is, can be used by 
UNIBUS (or MASSBUS) devices to 
tee odin where to load the primary 
ootstrap program. However, to 
calculate the physical memory address 
corresponding to this relative 
address, we must add in the povsteat 
offset of the base of the 64KB. 


3; 
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BOOTBLOCK 15-SEP-1984 23:40:1 AX/VMS Macro V04-00 P 
vo4-000 BOOSBLOCK = reads in and starts boot cod 2786-1383 33:69:49 Yeoors sre BOOTBLOCK.MAR: 1 ~— ) 


79 -SBTTL BOOSBLOCK = reads in and starts boot code 


—o 


p++ 
3 Functional description: 


The boot block sode reads the peaery bootstrap file into 
physical memory a block at a time. The code calls the device- 
dependent ROM subroutine once for each block in the bootstrap 
file. Then the routine jumps to byte 0 of the loaded code. 


Inputs: 
RO - type of boot device 
Ry = (UNIBUS) aq the of the 1/0 page for the boot device's 
a2 (MASSBUS) address of the device's MASSBUS adapter 


(UNIBUS) 32-bit physical address of the boot device's 
SR (bits <31:24> must be zero) 

(MASSBUS) adapter's controller/formatter number 

ARS unit number of the boot device 

R5 - software boot control flags 

R6 physical address of the device-dependent ROM routine 

that reads an arbitrary LBN into memory 


SP - <base_address + “X200> of 64kb of good memory 
Implicit inputs: 


UNIBUS adapter map registers 0-127 are mapped to the 64kb of 
good memory. MR 0 maps to first page of memory, etc. 


The boot block is loaded into the Ist page of the 64KB of 
memory, i.e. the page which corresponds to MR 0. 


The first Longuord (bytes 0-3) of the boot block contains 
the size of the primary bootstrap. 


The second longword (bytes 4-7) contains the starting LBN of 
the bootstrap file, expressed as swapped words. 


The third longword (bytes 8-11) contains the relative offset 
from the base of the 64KB of aenery into which we should load 
the primary bootstrap program. This must be a positive 

number less than or equal to 64KB-(size*512) where size is the 
size of the primary bootstrap. 


The starting LBN format is defined by DSC and cannot be 
changed. The load address is defined by WRITEBOOT and cannot 
be changed. 

Outputs: 


RO - type of boot device 
R1 - (UNIBUS) eceress of the 1/0 page for the boot device's 


U 
(MASSBUS) address of the device's MASSBUS adapter 
R2 - (UNIBUS) 18-bit UNIBUS address of the boot device's 
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WAAAAIAIIPINPININININININID 9 9 PPM FOOODODOOOO 000000000 O00 0000000000 coer S000 
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TBLOCK 15-SEP-1984 23:40:1 AX/VMS Macro V04-00 Page 
v04G- LOCK = reads in and starts boot co -SEP- :02: ooTs. LOCK .MAR; (3) 
itd id BOOSBLOC ds i d b d 4-SEP 1986 33 $3 if 8 OTS.SRCJBOOTBLOC 1 . 3 
. 3 § ; CSR 
.‘s3 5 (MASSBUS) adapter's control \er/ formatter number 
. wal 8 3 fi = unit number of the boot device 
© iss R - software boot control flags 
O0C 140; R6 - physical address of the device-dependent ROM routine 
: 11 3 that reads an arbitrary LBN into memory 
Bae 148 3 SP - <base_address + “X200> of 64kb of good memory 
one 132 3: Implicit outputs: 
Bebe 149 : The routine preserves RO-R1, R3, R4, R5-R6, RB, R10-R11, AP, and SP. 
4 149 ; Transfers control to the Oth byte of the primary bootstrap 
00c 150; program. 
4 $5 151; 
00C 136 i-- 
Babe 15 
00C 133 BOOSBLOCK _CODE: 3 Start of device independent code. 
FI AF 9F QOOC 155 POSHAB FILE_STATS : Move physical address of base of 
QOOF 138 3; 64KB of memory. 
6— FO AF CO QOOF 15 ADDL LOAD_ADDR, (SP) ; Add in relative load address. Result 
001 158 3: is physical address of load point. 
Bat 1? j Leave on stack for final JMP inst. 
0131 8F 6B 001 161 PUSHR #*M<RO,R4,R5,R8> 3 Save 4 registers for temps. 
54 EG AF DO 0017 168 MOVL FILE _SIZE.R4 : Get # of blocks in VMB. 
E6 AF BO OO1B 16 MOVW START_LBN,R8S 3; Get upper word value of LBN. 
EO AF E4 AF BO OOI1F 164 MOVW START_LBN+2,START_LBN ; Move lower word value of LBN into 
Base 165 ; lower word position. 
DE AF 58 B80 0024 166 MOVW R8, START LBN+2 3; Move upper word value to upper 
0028 16 ; word position. 
58 D9 AF 00 3 8 168 MOVL START_LBN,R8S ; Pickup the swapped LBN. 
55 D9 AF DO O002C 169 MOVL LOAD_ADDR,RS ; Get primary boot relative load addr. 
10 AE DD 00 170 PUSHL 16(SP) ; Copy physical transfer address to 
003 171 : top of stack for those devices such 
003 ive : as the TUS8 which need physteat 
iH \v? 3; rather than UNIBUS virtual addresses. 
00 175 READ_BLOCK: ; VMB read loop. 
6 18 0 176 JSB (R6) ; Call ROM read LBN routine. 
01 50 0 17 BLBS RO,NEXT_BLOCK :; Branch on successful read. 
0 ° 178 HALT 3; Halt on failure to read. 
33 190 NEXT_BLOCK: ; Read next block 
55 00000200 8F CO 0 9 181 ADDL = #*X 00.85 : Increment relative address 512 bytes. 
6€ 00000200 8F CO re 186 ADDL #*x200, (SP) : Increment physical address one page. 
BA AF 0D 04 1 INCL START_ ; Increment LBN number. 
58 67 AF 1) Ree 184 MOVL START _LBN,RS ; Next LBN is LBN¢l,. 
E254 «OF 4 185 SOBGTR R4,READ_BLOCK : If more blocks, loop. 
— 05 3 6 TSTL © (SP) + : Pop now useless data from stack. 
188 ; 
5 1 } 3: The or iaory bootstrap program is now in physical memory starting at 
2 190 ; the specified load address. Restore the saved registers, convert the 
: 133 3 CSR address to an 18-bit UNIBUS address. and transfer control to the 
3 program. 
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OOsE 
0060 


POPR 
BICL 


JMP 


#°M<RO,RG,RS,RB> 
#°XFFFCOOO0,R2 


a(SP)+ 


Restore registers. 

Reduce 32-bit CSR to 18-bit 

CSR that VMB expects. 

Jump to primary bootstrap program. 
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Symbol table 2786-1382 33:69:18 feoots sre BOOTBLOCK .MAR;1 _ &) 
BOOSBLOCK_CODE R 1 
FILE_SIZE R 1 
FILE_STATS & 1 
LOAD "ADDR R 1 
NEXT_BLOCK 000 i 1 
READ_BLOCK 0000033 R 1 
START_LBN 0000004 R 1 

Seer enon eecnerace 4 

: Psect synopsis ! 
PSECT name Allocation PSECT No. Attributes 

° $0008 ( 0.) 69 ( 0.) NOPIC USR CON ABS LCL NOSHR NOEXE NORD NOWRT NOVEC BYTE 
BLANK . 0000 ( 96.) 1¢ #1.) NOPIC USR CON REL LCL NQSHR EXE RD WRT NOVEC BYTE 
Quecucseseswessoceusessses 
H Performance indicators ! 

Phase Page faults CPU Time Elapsed Time 
Initialization 35 00:00: 00.08 00:00:00.29 
Command processing 141 00:00:00.60 8 80 Be Be 
Pass 68 00:00:00.55 0:00:01.56 
Symbol table sort 0 Bp Be: 8-98 Eb Se a BS 4 
Pass 2 52 00:00:00.39 00:00:01.01 
Symbol table output r Sb Shs Fb 00:00:00.01 
Psect synopsis output 1 00:00:00.02 BF #20288 OF 
Cross-reference output 0 bs Sos 00:00:00.0 
Assembler run totals 301 00:00:01.6 00:00:04.98 


The working get Limit was 900 popes. 

2158 bytes (5 pages) of virtua 
There were 1 
00 source Lines were read in Pass 


pages of virtual memory were used to define 


Macro Library name 
-8255$DUA28: pOOTS Ces 100Ts a8; 1 
> gg S0uAct: $YS.OBJJLIB.MLB;1 

$255$DUA28: (SYSLIBISTARLET.MLB; 2 
TOTALS (all Libraries) 


memory were used to buffer the intermediate co 
pages of symbol table space allocated to hold 7 non-local and 0 

" produc ing 9 object records in Pass 2. 
macros. 
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Macros 


defined 


de. 
local symbols. 


as com l 


0 GETS were required to define 0 macros. 
There were no errors, warnings or information messages. 
MACRO/LIS=L1IS$:BOOTBLOCK/0BJ=0BJ$:BOOTBLOCK MSRC$:BOOTBLOCK/UPDATE=(ENHS$:BOOTBLOCK) +EXECML$/L1IB+LIB$:BO0TS.MLB/LIB 
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